home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / src / cmds / initsprite / RCS / initsprite.man,v < prev    next >
Encoding:
Text File  |  1989-06-19  |  4.5 KB  |  148 lines
  1. head     1.2;
  2. branch   ;
  3. access   ;
  4. symbols  ;
  5. locks    ; strict;
  6. comment  @@;
  7.  
  8.  
  9. 1.2
  10. date     89.06.19.14.34.02;  author jhh;  state Exp;
  11. branches ;
  12. next     1.1;
  13.  
  14. 1.1
  15. date     89.01.18.11.46.16;  author ouster;  state Exp;
  16. branches ;
  17. next     ;
  18.  
  19.  
  20. desc
  21. @@
  22.  
  23.  
  24. 1.2
  25. log
  26. @New boot sequence
  27. @
  28. text
  29. @'\" Copyright 1989 Regents of the University of California
  30. '\" Permission to use, copy, modify, and distribute this
  31. '\" documentation for any purpose and without fee is hereby
  32. '\" granted, provided that this notice appears in all copies.
  33. '\" The University of California makes no representations about
  34. '\" the suitability of this material for any purpose.  It is
  35. '\" provided "as is" without express or implied warranty.
  36. '\" 
  37. '\" $Header: /sprite/lib/forms/RCS/cmd.man,v 1.1 89/02/23 13:08:24 ouster Exp $ SPRITE (Berkeley)
  38. '/" 
  39. .so \*(]ltmac.sprite
  40. .HS INITSPRITE cmds
  41. .BS
  42. .SH NAME
  43. initsprite \- First process executed during bootstrap
  44. .SH SYNOPSIS
  45. .nf
  46. \fBinitsprite\fR [\fB\-cfsx\fR] [\fB\-b\fR \fIbootcommand\fR] 
  47. .SH OPTIONS
  48. .IP "\fB\-b\fR \fIbootcommand\fR" 18
  49. \fIBootcommand\fR will be passed to the prom if the machine is rebooted.
  50. This happens if there is an error checking the root partition.
  51. The \fIbootcommands\fR parameter allows the reboot to be done using the same
  52. kernel and arguments as the original boot. 
  53. .IP "\fB\-c\fR" 18
  54. Causes a fileserver to run \fBrootcmds\fR before running \fBdiskcmds\fR. 
  55. \fBRootcmds\fR typically contains commands that allows a non-root fileserver
  56. to serve as root. 
  57. .IP "\fB\-f\fR" 18
  58. Causes a fileserver mount its disks without checking them.
  59. .IP "\fB\-s\fR" 18
  60. Causes \fBinitsprite\fR to exec a login instead of running \fBdiskcmds\fR 
  61. and \fBbootcmds\fR.
  62. .IP "\fB\-x\fR" 18
  63. Causes a fileserver to run \fBrootcmds\fR before running \fBdiskcmds\fR.
  64. .BE
  65.  
  66. .SH DESCRIPTION
  67. .PP
  68. \fBInitsprite\fR is the first user-level program executed when
  69. Sprite bootstraps itself on a machine.  It is invoked as root,
  70. with no arguments.  \fBInitsprite\fR opens the console terminal
  71. on its standard I/O channels, initializes environment variables
  72. like \fBHOST\fR, \fBMACHINE\fR, and \fBPATH\fR, and then invokes
  73. \fBcsh\fR command scripts to perform system initialization.
  74. .PP
  75. \fBInitsprite\fR looks first for a file \fB/boot/cmds/csh\fR;
  76. if it exists, then it is invoked to process the 
  77. command script in \fB/boot/diskcmds\fR.  The purpose of \fBdiskcmds\fR
  78. is to initialize a local disk, if there is one (if there is a local disk
  79. the kernel will load the prefix for \fB/bootTmp\fR and \fB/\fR before invoking
  80. \fBinitsprite\fR).
  81. .PP
  82. The main initialization script is in the file \fB/boot/bootcmds\fR.
  83. However, if it is desirable to perform special initialization
  84. operations for a particular machine, then there should exist a
  85. file \fB/hosts/\fImachine\fB/bootcmds\fR where \fImachine\fR
  86. is the name of the machine to be treated specially;  \fBinitsprite\fR
  87. checks for this file and executes it in preference to \fB/boot/bootcmds\fR.
  88. Typically, the machine-dependent script will source \fB/boot/bootcmds\fR
  89. and then perform machine-specific initialization afterwards.
  90. .PP
  91. If \fBinitsprite\fR successfully executes \fB/boot/bootcmds\fR (or a
  92. machine-specific replacement), then it exits.  Otherwise it
  93. invokes an interactive shell as root on the console device.
  94. Normally \fBbootcmds\fR takes care of starting up \fBlogin\fR
  95. processes.
  96. .PP
  97. For more information see the man page for \fBboot\fR.
  98.  
  99. .SH KEYWORDS
  100. bootstrap, initialization, startup, boot
  101. @
  102.  
  103.  
  104. 1.1
  105. log
  106. @Initial revision
  107. @
  108. text
  109. @d1 10
  110. a10 10
  111. ' Copyright 1989 Regents of the University of California
  112. ' Permission to use, copy, modify, and distribute this
  113. ' documentation for any purpose and without fee is hereby
  114. ' granted, provided that this notice appears in all copies.
  115. ' The University of California makes no representations about
  116. ' the suitability of this material for any purpose.  It is
  117. ' provided "as is" without express or implied warranty.
  118. ' 
  119. ' $Header: /sprite/lib/forms/RCS/proto.man,v 1.3 89/01/09 11:43:01 ouster Exp $ SPRITE (Berkeley)
  120. ' 
  121. d18 18
  122. a35 1
  123. \fBinitsprite\fR
  124. d47 1
  125. a47 1
  126. \fBInitsprite\fR looks first for a file \fB/local/bootBin/csh\fR;
  127. d49 1
  128. a49 1
  129. command script in \fB/local/diskcmds\fR.  The purpose of \fBdiskcmds\fR
  130. d51 1
  131. a51 1
  132. the kernel will load the prefix for \fB/local\fR before invoking
  133. d54 1
  134. a54 1
  135. The main initialization script is in the file \fB/bootcmds\fR.
  136. d59 2
  137. a60 2
  138. checks for this file and executes it in preference to \fB/bootcmds\fR.
  139. Typically, the machine-dependent script will source \fB/bootcmds\fR
  140. d63 1
  141. a63 1
  142. If \fBinitsprite\fR successfully executes \fB/bootcmds\fR (or a
  143. d68 2
  144. d72 1
  145. a72 1
  146. bootstrap, initialization, startup
  147. @
  148.